home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / X11 / xfig.z / xfig
Text File  |  1998-10-30  |  40KB  |  859 lines

  1.  
  2.  
  3.  
  4.      XXXXFFFFIIIIGGGG((((1111))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((RRRReeeelllleeeeaaaasssseeee 2222....0000,,,, ppppllll9999 ((((PPPPrrrroooottttooooccccoooollll 2222....0000))))))))  XXXXFFFFIIIIGGGG((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           xfig - Facility for Interactive Generation of figures under
  10.           X11
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           xxxxffffiiiigggg [----rrrriiii[[[[gggghhhhtttt]]]]] [----lllleeee[[[[fffftttt]]]]] [----LLLL[[[[aaaannnnddddssssccccaaaappppeeee]]]]] [----PPPP[[[[oooorrrrttttrrrraaaaiiiitttt]]]]] [----
  14.           ppppwwww[[[[iiiiddddtttthhhh]]]] _u_n_i_t_s] [----pppphhhh[[[[eeeeiiiigggghhhhtttt]]]] _u_n_i_t_s] [----nnnnooootttt[[[[rrrraaaacccckkkk]]]]] [----ttttrrrr[[[[aaaacccckkkk]]]]]
  15.           [----iiiinnnncccc[[[[hhhheeeessss]]]]] [----mmmmeeee[[[[ttttrrrriiiicccc]]]]] [----iiiinnnnvvvv[[[[eeeerrrrsssseeee]]]]] [----ddddeeee[[[[bbbbuuuugggg]]]]] [_f_i_l_e] [----
  16.           nnnnoooorrrrmmmmaaaallll[[[[FFFFoooonnnntttt]]]] _f_o_n_t] [----bbbboooolllldddd[[[[FFFFoooonnnntttt]]]] _f_o_n_t]
  17.  
  18.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.           _X_f_i_g is a menu-driven tool that allows the user to draw and
  20.           manipulate objects interactively in an X window. IIIItttt rrrruuuunnnnssss
  21.           uuuunnnnddddeeeerrrr XXXX vvvveeeerrrrssssiiiioooonnnn 11111111 and requires a three-button mouse.  _F_i_l_e
  22.           specifies the name of a file to be edited. The description
  23.           of objects in the file will be read at the start of _x_f_i_g.
  24.  
  25.           The output from _x_f_i_g can be printed in several ways:
  26.  
  27.           PPPPoooossssttttssssccccrrrriiiipppptttt ---- f2ps (_x_f_i_g to _p_o_s_t_s_c_r_i_p_t translator) is used to
  28.           produce _p_o_s_t_s_c_r_i_p_t from an _x_f_i_g file.  This can be sent
  29.           directly to a postscript printer or a file.
  30.  
  31.           TTTTrrrrooooffffffff ---- f2p (_x_f_i_g to _p_i_c(1) translator, also known by its
  32.           previous name _f_2_f_p(1L)) is used to translate _x_f_i_g files into
  33.           _p_i_c(1) language.  The resulting output may then be processed
  34.           in the same manner as any other _p_i_c file.  Note that area
  35.           fill is not supported by _f_2_p.
  36.  
  37.           NNNNooootttteeee:::: The _f_2_p and _f_2_p_s translators will be eventually phased
  38.           out because the _T_r_a_n_s_F_i_g package from Micah Beck is a more
  39.           general purpose translator for more graphics languages.  The
  40.           _T_r_a_n_s_F_i_g package can be used as a back-end processor to xfig
  41.           to produce various types of output:
  42.  
  43.           LaTeX -     _f_i_g_2_d_e_v -_L _l_a_t_e_x translates _x_f_i_g to _L_a_T_e_X
  44.                       picture environment commands which can be
  45.                       processed along with other _L_a_T_e_X commands.
  46.  
  47.           Postscript -
  48.                       _f_i_g_2_d_e_v -_L _p_s produces a postscript output.
  49.  
  50.           Pic -       _f_i_g_2_d_e_v -_L _p_i_c produces a pic output.
  51.  
  52.           PiCTeX -    _f_i_g_2_d_e_v -_L _p_i_c_t_e_x produces _P_i_C_T_e_X output.  This
  53.                       contains macros that can be used with the _P_i_C_T_e_X
  54.                       environment under _T_e_X or _L_a_T_e_X.
  55.  
  56.           Others -    fig2dev has options for these other languages:
  57.                       _b_o_x, _e_p_i_c, _e_e_p_i_c, and _e_e_p_i_c_e_m_u.
  58.  
  59.           The _T_r_a_n_s_F_i_g package is available from svax.cs.cornell.edu
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXFFFFIIIIGGGG((((1111))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((RRRReeeelllleeeeaaaasssseeee 2222....0000,,,, ppppllll9999 ((((PPPPrrrroooottttooooccccoooollll 2222....0000))))))))  XXXXFFFFIIIIGGGG((((1111))))
  71.  
  72.  
  73.  
  74.           (directory /pub/fig) and from sun.soe.clarkson.edu
  75.           (directory /pub/transfig) via anonymous ftp.  It is also
  76.           available by mail from the Clarkson archive server.  To find
  77.           out about using the server, send the one-line message "help"
  78.           to archive-server@sun.soe.clarkson.edu.
  79.  
  80.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  81.           ----rrrriiii  Change the position of the side panel window to the
  82.                right of the canvas window (default: left).
  83.  
  84.           ----lllleeee  Change the position of the side panel window to the
  85.                left of the canvas window.
  86.  
  87.           ----LLLL   Make _x_f_i_g come up in landscape mode (10" x 7.5").  This
  88.                is the default.
  89.  
  90.           ----PPPP   Make _x_f_i_g come up in portrait mode (7.5" x 10").
  91.  
  92.           ----ppppwwww _u_n_i_t_s
  93.                Make _x_f_i_g come up _u_n_i_t_s wide (where units are either cm
  94.                or in).
  95.  
  96.           ----pppphhhh _u_n_i_t_s
  97.                Make _x_f_i_g come up _u_n_i_t_s high (where units are either cm
  98.                or in).
  99.  
  100.           ----ttttrrrr  Turn on cursor (mouse) tracking arrows.
  101.  
  102.           ----nnnnoooo  Turn off cursor (mouse) tracking arrows.
  103.  
  104.           ----iiiinnnncccc Make inches the unit of choice (default).
  105.  
  106.           ----mmmmeeee  Make centimeters the unit of choice.
  107.  
  108.           ----iiiinnnnvvvv Use inverse video (white on black).
  109.  
  110.           ----ddddeeee  Turn on debugging mode.
  111.  
  112.           ----nnnnoooorrrrmmmmaaaallll _f_o_n_t
  113.                Cause the font used for questions to be _f_o_n_t.  This
  114.                font is also used on the canvas when the selected font
  115.                is not available in an X11 font.
  116.  
  117.           ----bbbboooolllldddd _f_o_n_t
  118.                Cause the font used for displaying messages to be _f_o_n_t.
  119.  
  120.      GGGGRRRRAAAAPPPPHHHHIIIICCCCAAAALLLL OOOOBBBBJJJJEEEECCCCTTTTSSSS
  121.           The objects in _x_f_i_g are divided into pppprrrriiiimmmmiiiittttiiiivvvveeee oooobbbbjjjjeeeeccccttttssss and
  122.           ccccoooommmmppppoooouuuunnnndddd oooobbbbjjjjeeeecccctttt. The primitive objects are: _A_R_C, _C_I_R_C_L_E,
  123.           _C_L_O_S_E_D _S_P_L_I_N_E, _E_L_L_I_P_S_E, _P_O_L_Y_L_I_N_E, _P_O_L_Y_G_O_N, _S_P_L_I_N_E, and _T_E_X_T.
  124.           A primitive can be moved, rotated, flipped, copied or
  125.           erased.  The TEXT primitive cannot be rotated or flipped.  A
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXFFFFIIIIGGGG((((1111))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((RRRReeeelllleeeeaaaasssseeee 2222....0000,,,, ppppllll9999 ((((PPPPrrrroooottttooooccccoooollll 2222....0000))))))))  XXXXFFFFIIIIGGGG((((1111))))
  137.  
  138.  
  139.  
  140.           compound object is composed of primitive objects. The
  141.           primitive objects that constitute a compound can not be
  142.           individually modified, but they can be manipulated as an
  143.           entity; a compound can be moved, rotated, flipped, copied or
  144.           erased.  An extra function that can be applied to a compound
  145.           object is ssssccccaaaalllliiiinnnngggg, which is not available for primitive
  146.           objects.
  147.  
  148.      DDDDIIIISSSSPPPPLLLLAAAAYYYY WWWWIIIINNNNDDDDOOOOWWWWSSSS
  149.           Nine windows comprise the display area of _x_f_i_g: the top
  150.           ruler, the side ruler, two panel windows, the message
  151.           window, three indicator windows showing current line
  152.           thickness, area-fill gray color and rounded box corner
  153.           radius, and the canvas window. The main panel window can be
  154.           placed to the left or right of the the canvas window
  155.           (default: left), and the second panel window is always below
  156.           the message window.  It contains buttons for quick access to
  157.           some of the pop-up menu commands.
  158.  
  159.      PPPPOOOOPPPP----UUUUPPPP MMMMEEEENNNNUUUU
  160.           The pop-up menu appears when the right mouse button is
  161.           pressed with the cursor positioned within the canvas window.
  162.           Positioning the cursor over the desired menu entry and
  163.           releasing the button selects a menu entry.
  164.  
  165.           There are a number of file accessing functions in the pop-up
  166.           menu.  Most of the time when one of these functions is
  167.           selected, the user will be asked for a file name.  If the
  168.           specified file can be located and the access permission are
  169.           granted, _x_f_i_g will carry out the function.  However in case
  170.           things go wrong, _x_f_i_g will abort the function and printed
  171.           the causes on the message window.  Most of the functions in
  172.           the pop-up menu can be directly access with the lower button
  173.           panel.
  174.  
  175.           _Q_u_i_t Exit from _x_f_i_g, discarding the figure. The user will be
  176.                asked to confirm the action, by clicking the left
  177.                button.
  178.  
  179.           _U_n_d_o Undo the last object creation or modification.
  180.  
  181.           _R_e_d_i_s_p_l_a_y
  182.                Redraw the canvas.
  183.  
  184.           _R_e_m_o_v_e _a_l_l
  185.                Remove all objects on the canvas window (can be
  186.                undone).
  187.  
  188.           _C_u_t  Select object to copy into the cut/paste file.  This
  189.                file is called ....xxxxffffiiiigggg in the user's $$$$HHHHOOOOMMMMEEEE directory.
  190.                This allows a user to run two or more xfig processes
  191.                and cut/paste objects between them.  If there is no
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXFFFFIIIIGGGG((((1111))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((RRRReeeelllleeeeaaaasssseeee 2222....0000,,,, ppppllll9999 ((((PPPPrrrroooottttooooccccoooollll 2222....0000))))))))  XXXXFFFFIIIIGGGG((((1111))))
  203.  
  204.  
  205.  
  206.                $$$$HHHHOOOOMMMMEEEE, a file is created in ////ttttmmmmpppp, called xxxxffffiiiigggg_P_I_D where
  207.                _P_I_D is the xfig process ID.
  208.  
  209.           _P_a_s_t_e
  210.                Paste the object previously copied into the cut/paste
  211.                file into the current figure.
  212.  
  213.           _E_d_i_t _f_i_l_e ...
  214.                The current contents of the canvas are cleared and the
  215.                figure is read from the specified file.  The user will
  216.                be asked for a file name.  This file will become the
  217.                current file.
  218.  
  219.           _S_a_v_e Save the current contents of the canvas in the current
  220.                file.  If no file is being edited, the user will be
  221.                asked for a file name as in the "Save in ..." function.
  222.  
  223.           _R_e_a_d _f_i_l_e ...
  224.                Read figure from the specified file and merge it with
  225.                the figure already shown on the canvas.  (The user will
  226.                be asked for a file name.)
  227.  
  228.           _S_a_v_e _i_n ...
  229.                Save the figure on the screen into a file specified by
  230.                the user.  (The user will be asked for a file name.)
  231.                If there is no current file name, it will be set to the
  232.                name specified in the save.
  233.  
  234.           _S_t_a_t_u_s
  235.                Show the name of the current file and directory.
  236.  
  237.           _C_h_a_n_g_e _D_i_r_e_c_t_o_r_y
  238.                Change the working directory.  Any file name without a
  239.                full path name will employ the current working
  240.                directory.
  241.  
  242.           _P_r_i_n_t _W_o_r_k_i_n_g _D_i_r_e_c_t_o_r_y
  243.                Show the current working directory.
  244.  
  245.           _S_a_v_e & _Q_u_i_t
  246.                Save the figure in the current file and exit from _x_f_i_g.
  247.                If there is no current file, the user will be asked for
  248.                a file name.  No confirmation will be asked.
  249.  
  250.           _S_a_v_e _a_s _B_i_t_m_a_p
  251.                Create an X11 bitmap from the figure the size of which
  252.                is determined by the enclosing rectangle of all the
  253.                figure plus a small border.
  254.  
  255.      BBBBOOOOTTTTTTTTOOOOMMMM PPPPAAAANNNNEEEELLLL CCCCOOOOMMMMMMMMAAAANNNNDDDD FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNNSSSS
  256.           Most of the buttons in the bottom panel are counterparts to
  257.           the pop-up menu functions.  However, there are additional
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 4/30/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXFFFFIIIIGGGG((((1111))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((RRRReeeelllleeeeaaaasssseeee 2222....0000,,,, ppppllll9999 ((((PPPPrrrroooottttooooccccoooollll 2222....0000))))))))  XXXXFFFFIIIIGGGG((((1111))))
  269.  
  270.  
  271.  
  272.           buttons for selecting font, font size, text line step, print
  273.           orientation (landscape or portrait) and the printer device
  274.           itself.
  275.  
  276.      BBBBOOOOTTTTTTTTOOOOMMMM PPPPAAAANNNNEEEELLLL WWWWIIIINNNNDDDDOOOOWWWW CCCCOOOOMMMMMMMMAAAANNNNDDDD DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS
  277.           _F_O_N_T _S_E_L_E_C_T
  278.                This button pops up a menu of 35 fonts available for
  279.                most Apple Postscript printers.  The name of the font
  280.                is printed in the font itself so that one may see what
  281.                that font looks like.  If a corresponding X11 font
  282.                exists, new text is created on the canvas using that
  283.                font.  _x_f_i_g uses the size of X11 font closest to that
  284.                selected by the font size button.  If the X11 font
  285.                doesn't exist, _x_f_i_g uses the font selected by the "-
  286.                normal" option.  To abort selection of a font, click on
  287.                the title of the menu.
  288.  
  289.           _F_O_N_T _S_I_Z_E
  290.                The left button decreases the point size of font used
  291.                on the canvas and printer.  The right button increases
  292.                the point size.
  293.  
  294.           _F_O_N_T _S_T_E_P
  295.                The left button decreases the interline spacing of text
  296.                and the right button increases the step.  The number
  297.                displayed give the multiple of the font height that
  298.                will be placed between lines on hitting return.
  299.  
  300.           _L_A_N_D_S_C_A_P_E/_P_O_R_T_R_A_I_T
  301.                Select landscape or portrait mode of printing.  The
  302.                default setting is that of the _x_f_i_g canvas.
  303.  
  304.           _P_R_I_N_T_E_R _S_E_L_E_C_T
  305.                Toggle through a list of printers available for
  306.                printing the figure. At present this list must be
  307.                compiled into _x_f_i_g.
  308.  
  309.           _T_E_X_T _J_U_S_T_I_F_I_C_A_T_I_O_N
  310.                Clicking this button cycles through selection of left,
  311.                center and right justification of text.
  312.  
  313.      SSSSIIIIDDDDEEEE PPPPAAAANNNNEEEELLLL WWWWIIIINNNNDDDDOOOOWWWW MMMMAAAANNNNIIIIPPPPUUUULLLLAAAATTTTIIIIOOOONNNN FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNNSSSS
  314.           Icons in the side panel window represent object manipulation
  315.           functions, modes and other drawing or modification aids.
  316.           Manipulation functions are selected by positioning the
  317.           cursor over it and clicking the left mouse button.  The
  318.           selected icon is highlighted, and a message describing its
  319.           function appears in the message window.
  320.  
  321.           The left and middle buttons are used to create and modify
  322.           objects in the canvas window.  Most actions start with
  323.           clicking of the left button and end with clicking of the
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 4/30/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      XXXXFFFFIIIIGGGG((((1111))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((RRRReeeelllleeeeaaaasssseeee 2222....0000,,,, ppppllll9999 ((((PPPPrrrroooottttooooccccoooollll 2222....0000))))))))  XXXXFFFFIIIIGGGG((((1111))))
  335.  
  336.  
  337.  
  338.           middle button.  There is no need to hold down a button while
  339.           positioning the cursor.
  340.  
  341.      SSSSIIIIDDDDEEEE PPPPAAAANNNNEEEELLLL WWWWIIIINNNNDDDDOOOOWWWW CCCCOOOOMMMMMMMMAAAANNNNDDDD DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS
  342.           Entries in the side panel window can be classified into two
  343.           categories:  object creation/modification/removal commands
  344.           (only one of which may be active at any one time), and
  345.           drawing aids (which act as toggle switches or settings).
  346.           There are two ways for drawing circles, two for ellipses,
  347.           two for splines and two for closed splines.  There are two
  348.           basic splines.  One is the interpolated spline in which the
  349.           spline pass thorough the entered points (knots).  The other
  350.           is the normal spline in which on control points are passed
  351.           by the spline (except for the two end points in the open
  352.           spline).
  353.  
  354.      OOOOBBBBJJJJEEEECCCCTTTT CCCCRRRREEEEAAAATTTTIIIIOOOONNNN////MMMMOOOODDDDIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN////RRRREEEEMMMMOOOOVVVVAAAALLLL
  355.           Multiple commands are grouped thematically in the following
  356.           descriptions (which is listed alphabetically).
  357.  
  358.           _A_R_E_A-_F_I_L_L _O_N/_O_F_F
  359.                Turn on or off area-fill mode.  This will affect any
  360.                arcs, boxes, polygons, circles, closed splines or
  361.                ellipses created subsequently.
  362.  
  363.           _A_D_D/_D_E_L_E_T_E _A_R_R_O_W_S
  364.                Add or delete arrow heads for _P_O_L_Y_L_I_N_E, _P_O_L_Y_G_O_N, _S_P_L_I_N_E
  365.                or _C_L_O_S_E_D _S_P_L_I_N_E objects (points of a _B_O_X can not be
  366.                added or deleted).
  367.  
  368.           _A_D_D/_D_E_L_E_T_E _P_O_I_N_T_S
  369.                Add or delete points for _P_O_L_Y_L_I_N_E, _P_O_L_Y_G_O_N, _S_P_L_I_N_E or
  370.                _C_L_O_S_E_D _S_P_L_I_N_E objects (points of a _B_O_X can not be added
  371.                or deleted).
  372.  
  373.           _A_R_C  Create an arc.  Specify three points using the left
  374.                button.
  375.  
  376.           _B_O_X  Create rectangular boxes.  Start with the left button
  377.                and terminate with the middle button.
  378.  
  379.           _R_O_U_N_D_E_D-_C_O_R_N_E_R _B_O_X
  380.                Create rectangular boxes with rounded corners.  Start
  381.                with the left button and terminate with the middle
  382.                button. The radius of the corners is selected by the
  383.                INCREASE/DECREASE RADIUS button.
  384.  
  385.           _B_R_E_A_K _C_O_M_P_O_U_N_D
  386.                Break a compound object to allow manipulation of its
  387.                component parts.  Click the left button on the bounding
  388.                box of the compound object.
  389.  
  390.  
  391.  
  392.  
  393.      Page 6                                          (printed 4/30/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      XXXXFFFFIIIIGGGG((((1111))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((RRRReeeelllleeeeaaaasssseeee 2222....0000,,,, ppppllll9999 ((((PPPPrrrroooottttooooccccoooollll 2222....0000))))))))  XXXXFFFFIIIIGGGG((((1111))))
  401.  
  402.  
  403.  
  404.           _C_H_A_N_G_E _O_B_J_E_C_T
  405.                Change settings for an existing object.  Click the left
  406.                button on the object and a pop-up menu will appear
  407.                showing existing settings for the object.  Some of the
  408.                menu entries may be changed by typing new values in the
  409.                appropriate windows. These allow cut and paste.  Others
  410.                pop up a sub-menu of multiple choices when pressed and
  411.                held.  Press the "done" button to apply the changes to
  412.                the object and finish.  Press the "apply" button to
  413.                apply the changes but keep the menu up for further
  414.                changes.  Press the "cancel" button to cancel the
  415.                changes and pop down the menu.
  416.  
  417.           _C_I_R_C_L_E
  418.                Create circles by specifying their radii or diameters.
  419.                Click the left button on the canvas window, move the
  420.                cursor until the desired radius or diameter is reached,
  421.                then click the middle button to terminate. The circle
  422.                will be drawn after the pressing of the middle button.
  423.  
  424.           _C_L_O_S_E_D _I_N_T_E_R_P_O_L_A_T_E_D _S_P_L_I_N_E
  425.                Create closed or periodic splines.  The function is
  426.                similar to _P_O_L_Y_G_O_N except that a closed interpolated
  427.                spline is drawn.  The spline will pass through the
  428.                points (knots).
  429.  
  430.           _C_L_O_S_E_D _S_P_L_I_N_E
  431.                Create closed or periodic spline objects.  The function
  432.                is similar to _P_O_L_Y_G_O_N except that a closed spline will
  433.                be drawn instead of polygon.  The entered points are
  434.                just control points; i.e., the spline will not pass any
  435.                of these points.
  436.  
  437.           _C_O_P_Y Copy object.  Click the left button over part of the
  438.                object to be copied (for _C_I_R_C_L_E and _E_L_L_I_P_S_E objects,
  439.                position on their circumferences).  Drag the object to
  440.                the desired position and click the middle button.  This
  441.                function as well as the following three functions
  442.                (_M_O_V_E, _M_O_V_E _P_O_I_N_T, _R_E_M_O_V_E) will cause point markers
  443.                (manipulation aids) to be shown on the canvas window.
  444.                There are no markers for _C_I_R_C_L_E or _E_L_L_I_P_S_E objects.
  445.  
  446.           _D_A_R_K_E_N/_L_I_G_H_T_E_N _A_R_E_A-_F_I_L_L _C_O_L_O_R
  447.                The left button lightens the area-fill color (black to
  448.                white through 20 gray levels).  The right button
  449.                darkens it.  The (approximate) current area fill color
  450.                is shown in the right-most indicator window.
  451.  
  452.           _E_L_L_I_P_S_E
  453.                Create ellipses using the same procedure as for the
  454.                drawing of circles.
  455.  
  456.  
  457.  
  458.  
  459.      Page 7                                          (printed 4/30/98)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      XXXXFFFFIIIIGGGG((((1111))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((RRRReeeelllleeeeaaaasssseeee 2222....0000,,,, ppppllll9999 ((((PPPPrrrroooottttooooccccoooollll 2222....0000))))))))  XXXXFFFFIIIIGGGG((((1111))))
  467.  
  468.  
  469.  
  470.           _F_L_I_P Invert the object (middle button) or produce a mirror-
  471.                image copy of an object (left button). Point to part of
  472.                the object ("the handle"), click the appropriate
  473.                button.
  474.  
  475.           _G_L_U_E Glue the objects within a bounding box into a compound
  476.                object (the bounding box itself is not part of the
  477.                figure; it is a visual aid for manipulating the
  478.                compound).
  479.  
  480.           _I_N_C_R_E_A_S_E/_D_E_C_R_E_A_S_E _L_I_N_E _T_H_I_C_K_N_E_S_S
  481.                The left button decreases the line thickness by one
  482.                pixel, the right button increases it by one pixel.  The
  483.                current line thickness is shown in the left-most
  484.                indicator window.
  485.  
  486.           _I_N_C_R_E_A_S_E/_D_E_C_R_E_A_S_E _R_A_D_I_U_S _O_F _R_O_U_N_D_E_D _B_O_X _C_O_R_N_E_R_S
  487.                The left button decreases the radius used in the
  488.                corners of rounded boxes, the right button increases
  489.                it. The current radius is shown in the middle indicator
  490.                window.
  491.  
  492.           _I_N_T_E_R_P_O_L_A_T_E_D _S_P_L_I_N_E
  493.                Create (cubic spline) spline objects.  Enter control
  494.                vectors in the same way as for creation of a _P_O_L_Y_L_I_N_E
  495.                object.  At least three points (two control vectors)
  496.                must be entered.  The spline will pass through the
  497.                entered points.
  498.  
  499.           _M_O_V_E Move objects in the same way as in _C_O_P_Y.
  500.  
  501.           _M_O_V_E _P_O_I_N_T
  502.                Modify the position of points of _P_O_L_Y_L_I_N_E, _B_O_X,
  503.                _P_O_L_Y_G_O_N, _E_L_L_I_P_S_E, _A_R_C and _S_P_L_I_N_E objects.  Click the
  504.                left button over the desired point, reposition the
  505.                point, and click the middle button.  Note that _B_O_X,
  506.                _R_O_U_N_D_E_D-_C_O_R_N_E_R _B_O_X and _P_O_L_Y_G_O_N objects are internally
  507.                stored as _P_O_L_Y_L_I_N_E objects, and therefore moving
  508.                certain points may open these objects.
  509.  
  510.           _P_O_L_Y_G_O_N
  511.                Same as _P_O_L_Y_L_I_N_E except that a line segment is drawn
  512.                connecting the first and last points entered.
  513.  
  514.           _P_O_L_Y_L_I_N_E
  515.                Create polylines (line segments connecting a sequence
  516.                of points).  Enter points by clicking the left button
  517.                at the desired positions on the canvas window.  Click
  518.                the middle button to terminate.
  519.  
  520.           _R_E_M_O_V_E
  521.                Remove (or delete) objects.
  522.  
  523.  
  524.  
  525.      Page 8                                          (printed 4/30/98)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      XXXXFFFFIIIIGGGG((((1111))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((RRRReeeelllleeeeaaaasssseeee 2222....0000,,,, ppppllll9999 ((((PPPPrrrroooottttooooccccoooollll 2222....0000))))))))  XXXXFFFFIIIIGGGG((((1111))))
  533.  
  534.  
  535.  
  536.           _R_O_T_A_T_E
  537.                Rotate the object (middle button) or copy (left button)
  538.                +90 degrees.
  539.  
  540.           _S_C_A_L_E _C_O_M_P_O_U_N_D
  541.                Only compound objects can be scaled.  Click the left
  542.                button on a corner of the bounding box, stretch the
  543.                bounding box to the desired size, and click the middle
  544.                button.  Or click the left button on a side of the
  545.                bounding box, stretch that side to the desired size,
  546.                and click the middle button.
  547.  
  548.           _S_P_L_I_N_E
  549.                Create (quadratic spline) spline objects.  Enter
  550.                control vectors in the same way as for creation of a
  551.                _P_O_L_Y_L_I_N_E object.  At least three points (two control
  552.                vectors) must be entered.  The spline will pass only
  553.                the two end points.
  554.  
  555.           _T_E_X_T Create text strings. Click the left button at the
  556.                desired position on the canvas window, then enter text
  557.                from the keyboard.  Text is drawn using the current
  558.                font, font size and justification settings.  A DEL or
  559.                ^H (backspace) will delete a character, while a ^U will
  560.                kill the entire line.  Terminate by clicking the middle
  561.                button or typing the return key. If return is used, the
  562.                text pointer automatically moves to the next "line", a
  563.                distance of the font height times the value in the TEXT
  564.                STEP button, and text input mode is re-entered.  To
  565.                terminate text fully, click the middle button or choose
  566.                any panel button that changes modes (e.g. box, save,
  567.                etc).  To edit text, click on an existing text string
  568.                with the left button.  Insertion of characters will
  569.                take place at that point.  Or, use the popup change
  570.                object button to modify the text.
  571.  
  572.           _T_U_R_N Turn _P_O_L_Y_G_O_N into a _C_L_O_S_E_D _I_N_T_E_R_P_O_L_A_T_E_D _S_P_L_I_N_E object,
  573.                or turn _P_O_L_Y_L_I_N_E into a _I_N_T_E_R_P_O_L_A_T_E_D _S_P_L_I_N_E object.
  574.  
  575.      DDDDRRRRAAAAWWWWIIIINNNNGGGG AAAAIIIIDDDDSSSS
  576.           Drawing aids act as toggle switches. More than one can be
  577.           selected at a time (except for _G_R_I_D and the line drawing
  578.           modes).
  579.  
  580.           _A_U_T_O _F_O_R_W_A_R_D/_B_A_C_K_W_A_R_D _A_R_R_O_W
  581.                Automatically add forward/backward arrow heads to
  582.                _P_O_L_Y_L_I_N_E, _S_P_L_I_N_E or _A_R_C objects.
  583.  
  584.           _M_A_G_N_E_T
  585.                Round points to the nearest 1/16 of an inch.  This
  586.                affects every function, and is provided as an alignment
  587.                aid.
  588.  
  589.  
  590.  
  591.      Page 9                                          (printed 4/30/98)
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      XXXXFFFFIIIIGGGG((((1111))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((RRRReeeelllleeeeaaaasssseeee 2222....0000,,,, ppppllll9999 ((((PPPPrrrroooottttooooccccoooollll 2222....0000))))))))  XXXXFFFFIIIIGGGG((((1111))))
  599.  
  600.  
  601.  
  602.           _U_N_R_E_S_T_R_I_C_T_E_D
  603.                Allow lines to be drawn with any slope.
  604.  
  605.           _L_A_T_E_X _L_I_N_E
  606.                Allow lines to be drawn only at slopes which can be
  607.                handled by LaTeX picture environment lines: slope =
  608.                x/y, where x,y are integers in the range [-6,6].
  609.  
  610.           _L_A_T_E_X _V_E_C_T_O_R
  611.                Allow lines to be drawn only at slopes which can be
  612.                handled by LaTeX picture environment vectors: slope =
  613.                x/y, where x,y are integers in the range [-4,4].
  614.  
  615.           _M_A_N_H_A_T_T_A_N
  616.                Enforce drawing of lines in the horizontal and vertical
  617.                direction only.  Both _M_A_N_H_A_T_T_A_N and _M_O_U_N_T_A_I_N can be
  618.                turned on simultaneously. The creations of _P_O_L_Y_G_O_N,
  619.                _P_O_L_Y_L_I_N_E and _S_P_L_I_N_E objects are affected by these two
  620.                modes.
  621.  
  622.           _M_O_U_N_T_A_I_N
  623.                Enforce drawing of only diagonal lines.  Both _M_A_N_H_A_T_T_A_N
  624.                and _M_O_U_N_T_A_I_N can be turned on simultaneously. The
  625.                creations of _P_O_L_Y_G_O_N, _P_O_L_Y_L_I_N_E and _S_P_L_I_N_E objects are
  626.                affected by these two modes.
  627.  
  628.           _M_A_N_H_A_T_T_A_N _M_O_U_N_T_A_I_N
  629.                Allow lines to be drawn at any slope allowed when in
  630.                MOUNTAIN or MANHATTAN modes.
  631.  
  632.           _G_R_I_D Display either the quarter- or half-inch grids (left
  633.                button).
  634.  
  635.           _S_O_L_I_D/_D_A_S_H_E_D/_D_O_T_T_E_D _L_I_N_E _S_T_Y_L_E
  636.                Toggle between solid, dashed and dotted line styles.
  637.                The dash length is fixed at 0.05 inch.
  638.  
  639.      XXXX DDDDEEEEFFFFAAAAUUUULLLLTTTTSSSS
  640.           The overall widget name(Class) is
  641.           xfig.fig(Fig.TopLevelShell).  This set of resources
  642.           correspond to the command line arguments:
  643.  
  644.           justify     (boolean:false) -right (true) and -left (false)
  645.                       arguments
  646.  
  647.           landscape   (boolean:true) -Landscape and -Portrait
  648.                       arguments
  649.  
  650.           pwidth      (integer:7.5 or 10 inches) -pwidth argument
  651.  
  652.           pheight     (integer:10 or 7.5 inches) -pheight argument
  653.  
  654.  
  655.  
  656.  
  657.      Page 10                                         (printed 4/30/98)
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.      XXXXFFFFIIIIGGGG((((1111))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((RRRReeeelllleeeeaaaasssseeee 2222....0000,,,, ppppllll9999 ((((PPPPrrrroooottttooooccccoooollll 2222....0000))))))))  XXXXFFFFIIIIGGGG((((1111))))
  665.  
  666.  
  667.  
  668.           trackCursor (boolean:on) -track and -notrack arguments
  669.  
  670.           inches      (boolean:true) -inches and -metric arguments
  671.  
  672.           reverseVideo(boolean:off) -inverse argument
  673.  
  674.           debug       (boolean:off) -debug argument
  675.  
  676.           normalFont  (string:fixed) -normal argument
  677.  
  678.           boldFont    (string:8x13bold) -bold argument
  679.  
  680.           These arguments correspond to the widgets which make up
  681.           _x_f_i_g.
  682.  
  683.           overall window form(Form)
  684.  
  685.           side panel     form.side_panel(Form.Box)
  686.  
  687.           bottom panel   form.bottom_panel(Form.Box)
  688.  
  689.           buttons        form.side_panel.button(Form.Box.Command)
  690.                          form.bottom_panel.button(Form.Box.Command)
  691.  
  692.           top ruler      form.truler(Form.Label)
  693.  
  694.           side ruler     form.sruler(Form.Label)
  695.  
  696.           canvas         form.canvas(Form.Label)
  697.  
  698.           message window form.message(Form.Command)
  699.  
  700.           command menu   form.popup_menu.menu(Form.OverrideShell.Box)
  701.  
  702.           command menu title
  703.                          form.popup_menu.menu.title(Form.OverrideShell.Box.Label)
  704.  
  705.           command menu items
  706.                          form.popup_menu.menu.pane(Form.OverrideShell.Box.Command)
  707.  
  708.           font menu      form.font_menu.menu(Form.OverrideShell.Box)
  709.  
  710.           change menu    change.form(TransientShell.Form)
  711.  
  712.           indicator panel
  713.                          form.indicator(Form.Box)
  714.  
  715.           font indicator window
  716.                          form.font_indicator(Form.Label)
  717.  
  718.           For example, to set the background of the side panel to blue
  719.           and the indicator panel background to green the resources
  720.  
  721.  
  722.  
  723.      Page 11                                         (printed 4/30/98)
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.      XXXXFFFFIIIIGGGG((((1111))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((RRRReeeelllleeeeaaaasssseeee 2222....0000,,,, ppppllll9999 ((((PPPPrrrroooottttooooccccoooollll 2222....0000))))))))  XXXXFFFFIIIIGGGG((((1111))))
  731.  
  732.  
  733.  
  734.           would be:
  735.           xfig*form.panel.background: blue
  736.           xfig*form.indicator.background: blue
  737.  
  738.      BBBBUUUUGGGGSSSS
  739.           Creating a text object is not "Undoable".
  740.  
  741.           Area fill doesn't show on the canvas for closed splines, but
  742.           are filled when printed.  This has to do with the way the
  743.           splines are generated on the screen.
  744.  
  745.           Undoing the creation of a compound object deletes the
  746.           objects outside the compound object.  Undoing the undo
  747.           doesn't bring them back.
  748.  
  749.           Undoing a move-point of a box or arc-box will corrupt the
  750.           object.
  751.  
  752.           Ellipses which are too narrow are not drawn correctly.
  753.  
  754.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  755.           Brian W. Kernighan _P_I_C - _A _G_r_a_p_h_i_c_s _L_a_n_g_u_a_g_e _f_o_r _T_y_p_e_s_e_t_t_i_n_g
  756.           _U_s_e_r _M_a_n_u_a_l
  757.           f2ps(1) f2p(1)
  758.  
  759.      AAAACCCCKKKKNNNNOOOOWWWWLLLLEEEEDDDDGGGGEEEEMMMMEEEENNNNTTTT
  760.           Many thanks goes to Professor Donald E. Fussell who inspired
  761.           the creation of this tool.
  762.  
  763.      AAAAUUUUTTTTHHHHOOOORRRRSSSS
  764.           Original author:
  765.           Supoj Sutanthavibul
  766.           University of Texas at Austin
  767.           (supoj@sally.utexas.edu)
  768.  
  769.           Manual page modified by:
  770.           R. P. C. Rodgers
  771.           UCSF School of Pharmacy
  772.           San Francisco, CA 94118
  773.  
  774.           The LaTeX line drawing modes were contributed by:
  775.           Frank Schmuck
  776.           Cornell University
  777.  
  778.           X11 port by:
  779.           Ken Yap
  780.           Rochester
  781.           (ken@cs.rochester.edu)
  782.  
  783.           Variable window sizes, cleanup of X11 port, right hand side
  784.           panel under X11, X11 manual page provided by:
  785.           Dana Chee
  786.  
  787.  
  788.  
  789.      Page 12                                         (printed 4/30/98)
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.      XXXXFFFFIIIIGGGG((((1111))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((RRRReeeelllleeeeaaaasssseeee 2222....0000,,,, ppppllll9999 ((((PPPPrrrroooottttooooccccoooollll 2222....0000))))))))  XXXXFFFFIIIIGGGG((((1111))))
  797.  
  798.  
  799.  
  800.           Bellcore
  801.           (dana@bellcore.com)
  802.  
  803.           Cleanup of color port to X11 by:
  804.           John T. Kohl
  805.           MIT
  806.           (jtkohl@athena.mit.edu)
  807.  
  808.           Area fill, multiple line thicknesses, multiple fonts and
  809.           font sizes, bottom panel, line style/thickness modification
  810.           of objects by:
  811.  
  812.           Brian V. Smith
  813.           Lawrence Berkeley Laboratory
  814.           (standard disclaimer applies)
  815.           (bvsmith@lbl.gov)
  816.  
  817.           Popup change-object menu by:
  818.           Jon Tombs (jon%robots.oxford.ac.uk@nsfnet-relay.ac.uk)
  819.           and
  820.           Frank Schmuck
  821.           (schmuck@svax.cs.cornell.edu)
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.      Page 13                                         (printed 4/30/98)
  856.  
  857.  
  858.  
  859.